home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / dirmgr02.zip / DIRMGR.DOC < prev    next >
Text File  |  1991-11-05  |  11KB  |  279 lines

  1.  
  2.  
  3.  
  4.                                    DIRMGR
  5.  
  6.                   PCBoard Files Listing Directory Manager
  7.  
  8.  
  9.                                  Supports:
  10.                           over 2,100,000,000 files
  11.                     over 9,200,000,000,000,000,000 bytes
  12.                          Customized color settings
  13.                                  VERY FAST!
  14.  
  15.  
  16.                        Version 1ß02, 05-November-1991
  17.  
  18.                                 DIRMGR02.ZIP
  19.  
  20.                     For use with PCBoard Versions 14.5x
  21.  
  22.  
  23.  
  24.  
  25.                       Copyright (C) 1991 Geoffrey Sy;
  26.                             ALL RIGHTS RESERVED
  27.  
  28.  
  29.  
  30.         See DIRMGR.NEW for a listing of changes since version 1ß01.
  31.  
  32.  
  33.  
  34.                        This program is supported by:
  35.  
  36.  
  37.                                 Geoffrey Sy
  38.                                51 Wyatt Walk
  39.                           Toronto, Ontario  Canada
  40.                                   M5A 3T3
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50. *
  51.  
  52.  
  53.                             TABLE OF CONTENTS 
  54.                             =================
  55.  
  56.  
  57. Introduction ........................................................
  58.  
  59. Installation ........................................................
  60.      Editing DIRMGR's Configuration Files ...........................
  61.  
  62.  
  63. Program Capabilities ................................................
  64.      Multi-Tasking/Node Support .....................................
  65.      Network, File Sharing Support ..................................
  66.  
  67. Error Codes .........................................................
  68.      Bug Report Procedure ...........................................
  69.  
  70. Support/Registrations................................................
  71.  
  72. Disclaimers/Copyrights ..............................................
  73.  
  74.  
  75.  
  76.                                INTRODUCTION
  77.                                ============
  78.  
  79. This program makes the little ANSI header on PCBoard DIRxx files listings.
  80. I wrote the program because I couldn't find one that is NICE enough or can
  81. handle enough MILLIONS of TERABYTES or or FAST enough.
  82.  
  83.                       PROGRAM INSTALLATION/OPERATION
  84.                       ==============================
  85.  
  86. Step #1:
  87. =======
  88.  
  89. Make a directory and put the DIRMGR.EXE into it.  You can put the DIRCLR.EXE
  90. too if you want.  The DIRCLR.EXE was included for removing the headers. This
  91. is needed to prevent some programs that process the DIRxx files from hangups
  92. if there are such headers present.
  93.  
  94. Step #2:
  95. ========
  96.  
  97. Edit the configuration. I'll include a utility to manage them for you later.
  98. There is a sample file called DIRMGR.CNF that'll give you the idea.  This is
  99. a straight ASCII file containing 6 lines, they are as follows:
  100.  
  101.  1 - Header for your DIR file
  102.  
  103.  2 - Header for your DIRxx files
  104.  
  105.  * Both of the above may be substituted with the %D:\PATH\FILE to tell PCB *
  106.  * to include such files from disk.  Future update will include individual *
  107.  * header file for each DIRxx files - well, will see how the support goes. *
  108.  
  109.  3 - Complete pathname to the DIR file.  This is the menu that shows up when
  110.      the users us the (F)iles command in PCBoard.
  111.  
  112.  4 - Complete pathname to the DIR.LST file.  This is the file that contains
  113.      all your paths to your DIRxx files and the descriptions for them.
  114.  
  115.  5 - Complete pathname to the New Uploads DIRxx file.  This is the file
  116.      containing the files description of new conference uploads.
  117.  
  118.  6 - Your customized title for the New Uploads DIRxx area.
  119.  
  120.  
  121. Step #3:
  122. ========
  123.  
  124. BACKUP YOUR HARD DRIVE!  ...Well at least the DIRxx files.  I won't be held
  125. responsible for what happens in the next step.
  126.  
  127. Step #4:
  128. ========
  129.  
  130. TRIAL RUN.
  131.  
  132. At the DOS prompt type:
  133.  
  134. DIRMGR DIRMGR.CNF C:\PCB /INIT
  135.           │         │      └──  This parameter is needed the first time.
  136.           │         └─────────  The path to your PCBFILER.DEF file.
  137.           └───────────────────  The configuration file created in step #2.
  138.  
  139. The first time you run DIRMGR, be sure to use the /INIT option.  This option
  140. is needed to initialize the directories.  The initialization process removes
  141. any old header and adds the macro to display the new header file. After this
  142. process you'll see files with the .$DM extension.  These are backups of your
  143. original directories, you may delete them if you don't need them.
  144.  
  145. While the program is running, full verbose error messages and current status
  146. are displayed on line 6 of the status screen. There's a timer on line 4 and
  147. files/bytes status indicator on line 7.
  148.  
  149. If you have a runtime error please check the runtime error codes in this
  150. document.  If the program just hangs, you're probably running the AT version
  151. on your PC/XT.  Make sure you run the correct version as your CPU.
  152.  
  153. Step #5:
  154. ========
  155.  
  156. Please support ShareWare.  If you're going to use the program regularly,
  157. please make a point to register it.  Your registration will encourage
  158. further support and development of this and other programs.  Without support
  159. and feedback, programs such as this will simply disappear.
  160.  
  161.  
  162.                             PROGRAM CAPABILITIES
  163.                             ====================
  164.  
  165.      +    Will run under a 128K window in DesqView, but will not share or
  166.           give up CPU cycles.  DirMgr does very fast DMA writes to video
  167.           RAM, so screen bleed-through may occur on 286 CPUs running DV.
  168.  
  169.      +    File-sharing has been provided.  This doesn't mean that you can
  170.           run it unattended while users are on-line, but you can probably
  171.           get away with it if the users aren't reading the DIRS description
  172.           or the header of the DIRxx files.  Make sure SHARE.EXE is loaded.
  173.  
  174.      +    Headers and DIRS description colour settings co-ordinate with
  175.           those set in PCBFILER.DEF.
  176.  
  177.      +    Will count OFF-LINE files.  DELETED files are not counted.  If you
  178.           had deleted the file what's the use of including them?
  179.  
  180.      +    Can probably processed at least 2000 lines per second.  I haven't
  181.           really run any benchmarks on this, but it really feels faster than
  182.           all the other programs I've tried.  I've included a timer to show
  183.           the number of elapsed seconds for you to compare the results with
  184.           other similiar programs.
  185.  
  186.  
  187.                                 ERROR CODES
  188.                                 ===========
  189.  
  190.          Error    Class     Description
  191.  
  192.             2     DOS:       File not found  (Check command line)
  193.             3     DOS:       Path not found
  194.             4     DOS:       Too many open files (Check CONFIG.SYS)
  195.             5     DOS:       File access denied
  196.             6     DOS:       Bad file handle
  197.            12     DOS:       Bad file access code
  198.            16     DOS:       Can't remove current dir
  199.            15     DOS:       Bad drive number
  200.           100     I/O:       Disk read error
  201.           101     I/O:       Disk write error
  202.           102     I/O:       File not assigned
  203.           103     I/O:       File not open
  204.           104     I/O:       File not open for input
  205.           105     I/O:       File not open for output
  206.           106     I/O:       Bad numeric format (Check numbers in .CNF)     
  207.           150     CRITICAL:  Disk is write-protected
  208.           151     CRITICAL:  Unknown unit
  209.           152     CRITICAL:  Drive not ready
  210.           153     CRITICAL:  Unknown command
  211.           154     CRITICAL:  CRC error in data
  212.           156     CRITICAL:  Disk seek error
  213.           157     CRITICAL:  Unknown media type
  214.           158     CRITICAL:  Sector not found
  215.           159     CRITICAL:  Printer out of paper
  216.           160     CRITICAL:  Device write fault
  217.           161     CRITICAL:  Device read fault
  218.           162     CRITICAL:  Network or Hardware failure
  219.           200     FATAL:     Division by zero
  220.           201     FATAL:     Range check
  221.           202     FATAL:     Stack overflow
  222.           203     FATAL:     Heap overflow
  223.           204     FATAL:     Bad pointer operation
  224.           205     FATAL:     Floating point overflow
  225.           206     FATAL:     Floating point underflow
  226.           207     FATAL:     Bad floating point operation
  227.           208     FATAL:     Overlay Manager not initialized
  228.  
  229.  
  230.  
  231.                                 BUG REPORTS
  232.                                 ===========
  233.  
  234. Catch the bug, put it into a ZIPloc bag and upload it to my support board.
  235. Please provide the version number you're using and any message the program
  236. returns as well as the steps required to re-create the error. The current
  237. number is (416) 287-9002 (HST) and (416) 286-8734 (slow).  I have no control
  238. over whether or not the board is up. This'll depend on how deep in debt Jeff
  239. (the SysOp of my support BBS) is.  If he's in debt he'll need to auction off
  240. his equipments.
  241.  
  242.                                   SUPPORT
  243.                                   =======
  244.  
  245. If you have any questions, bugs, or suggestions, please contact me. I may be
  246. reached on the NaNET(tm), ShareWare, Intelec(tm), City2City(tm), Rime(tm),
  247. and other PCBoard echoes.  Or by mail to the above address.  Registered
  248. users may contact me using the voice number in the registration document.
  249.  
  250. Since this is user supported software, I don't expect you to register if you
  251. don't like it or if it doesn't meet your needs.  Just stop using it after a
  252. reasonable trial period (2-3 weeks). The program is not crippled in any way,
  253. there are no delays, timebombs, etc, etc.  If you like the program and use
  254. it regularly, please register it. Registration only costs C$10.00 and you'll
  255. receive unlimited voice support and upgrades.  Please mail your registration
  256. to the above address.
  257.  
  258. Registration entitiles you to unlimited upgrades and support.  You may even
  259. call me up at odd hours and your queries don't have to be related to this
  260. package. I can pretty well provide solutions to most of the common PCBoard
  261. operation problems.
  262.  
  263.  
  264.                       STANDARD DISCLAIMERS/COPYRIGHTS
  265.                       ===============================
  266.  
  267. This program is provided on an "AS IS" basis.  No warranty of any kind is
  268. expressed or implied.  YOU USE THIS PROGRAM AT YOUR OWN RISK.  I take no
  269. responsibility for any damage caused directly or indirectly from the use or
  270. the inability to use this program.
  271.  
  272.  
  273. PCBoard           - Copyrighted: Clarke Development Company
  274. City2City         - Trade Marks of FUTURETRON Online Services
  275. NaNET             - Trade Marks of Canada Remote Systems Online Services
  276. Intelec, RIME     - Trade Marks of their respeced trademark holders
  277. Other             - Copyrighted: Respected Owners
  278.  
  279.